home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / graphics / qpeg11c.zip / QPEG.DOK < prev    next >
Text File  |  1993-11-18  |  13KB  |  270 lines
  1. -----------------------------------------------------------------------------
  2.  
  3.                                    Q P E G
  4.                                  ___________
  5.                                  ~^~^~^~^~^~
  6.  
  7.       Ein schneller JPEG-Anzeiger für MS-DOS.  Benötigt VGA und 80386+.
  8.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.  
  10. Copyright (c) 1993 by TBH-Softworx -- alle Rechte vorbehalten
  11.           Oliver Fromme, Klingestr. 2, 38640 Goslar, Germany
  12.           Internet email: inof@asterix.rz.tu-clausthal.de
  13.  
  14. Version 1.1c vom 19-Nov-1993
  15.  
  16. Dieses Programm ist Shareware.  Du kannst es kopieren, benutzen, Deinen
  17. Freunden geben, auf eine BBS oder ähnliches laden, unter den folgenden
  18. Bedingungen:
  19.  
  20.  * Es darf kein Geld / keine Gebühr dafür genommen werden.  Falls es auf
  21.    eine BBS geladen wird, muß es von Benutzern kostenfrei abgerufen
  22.    werden können (abgesehen von den sowieso anfallenden Benutzungsgebühren
  23.    der BBS).
  24.  * Nur das Original-Paket darf weitergegeben bzw. verteilt werden, das
  25.    alle Dateien enthält.
  26.  * Die Dateien dürfen in keiner Weise modifiziert werden, außer:
  27.    Die INI, CFG, ASM und DRV Dateien dürfen für private Zwecke verändert
  28.    werden.  Veränderte Versionen dieser Dateien dürfen aber ohne
  29.    ausdrückliche Erlaubnis des Autors von QPEG nicht weitergegeben werden.
  30.  * QPEG darf nicht Teil eines kommerziellen Produkts oder einer kommerziellen
  31.    Dienstleistung sein ohne schriftliche Erlaubnis des Autors von QPEG.
  32.  * QPEG muß registriert werden, wenn es in einer Firma, öffentlichen
  33.    Einrichtung, Behörde u.ä. verwendet wird.
  34.  
  35. Diese Software besteht aus den folgenden Dateien:
  36.  - QPEG.EXE        das Hauptprogramm
  37.  - QPEG.INI        Initialisierungs-Datei (ASCII-Text)
  38.  - QPEG.DAT        Tabellendatei für QPEG (nicht verändern!)
  39.  - QPEG.DO?        die Anleitung
  40.  - CHANGES.DO?     Änderungen von vorhergehenden Versionen
  41.  - INSTALL.DO?     wie QPEG konfiguriert bzw. installiert wird
  42.  - FAQ.DO?         Fragen, Antworten, Quintessenzen
  43.  - REGISTER.FRM    Registrierungsformular
  44.  - JPEGUNIT.PAS    "Bestellschein" für die JPEG Pascal Unit
  45.  - TBHGLOGO.RLE    TBH-Logo für die Benutzeroberfläche
  46.  - CFG\*.CFG       diverse Konfigurationsdateien
  47.  - CFG\CFG.DOC     Beschreibung des Dateiformats
  48.  - DRV\*.DRV       diverse Video-Treiber
  49.  - DRVSRC\*.ASM    Quelltexte der Video-Treiber
  50.  - DRVSRC\DRV.DOC  Beschreibung des Formats der Video-Treiber
  51. Textdateien mit einer DOC-Endung sind english, diejenigen mit einer
  52. DOK-Endung sind deutsch.
  53. Weiterhin können dabei einige Beispiel-JPEG-Dateien sein.  Sie sind
  54. allerdings nicht Teil des Software-Paketes.
  55.  
  56. WICHTIG:  Die Verwendung von Modi, die Deine Hardware (Grafikkarte und/oder
  57. Monitor) nicht verarbeiten kann, kann Deine Hardware beschädigen!
  58. Stelle sicher, daß nur unterstützte Modi verwendet werden.  Falls bei einem
  59. Modus das Bild flackert oder instabil ist (d.h. der Monitor kann das Bild
  60. nicht einfangen, oder das Bild "läuft"), breche QPEG sofort ab und lösche
  61. den betreffenden Modus aus der Konfigurationsdatei.
  62.  
  63. DIE VERWENDUNG VON QPEG EFOLGT AUF EIGENE GEFAHR!  DER AUTOR (OLIVER FROMME)
  64. HAFTET NICHT FÜR IRGENDWELCHE SCHÄDEN, DIE DURCH DIE VERWENDUNG VON QPEG
  65. ODER DURCH DIE UNFÄHIGKEIT, QPEG ZU VERWENDEN, DIREKT ODER INDIREKT
  66. RESULTIEREN.  FALLS SIE SICH NICHT SICHER SIND, ODER FALLS SIE DIES NICHT
  67. AKZEPTIEREN, BENUTZEN SIE QPEG NICHT!
  68.  
  69. QPEG ist preiswerte Shareware.  Falls Du QPEG nach einer Testzeit von 30
  70. Tagen weiterhin benutzt, solltest Du die kleine Registrierungsgebühr
  71. bezahlen.  (Ich möchte vermeiden zu sagen, daß Du Dich registrieren MUSST,
  72. aber genaugenommen MUSST Du.)
  73. Die Registrierung ist gültig für alle zukünftigen Versionen.  Auch der
  74. Quelltext der JPEG-Dekodierungsroutinen, die von QPEG verwendet werden,
  75. ist erhältlich.
  76. Um ein registrierter Benutzer zu werden, drucke bitte die Datei REGISTER.FRM,
  77. fülle das Formular aus, und sende es mit geeigneter Bezahlung an mich.
  78.  
  79. Alle Produktbezeichnungen, die in dieser Software genannt werden, sind
  80. Warenzeichen oder registrierte Warenzeichen der jeweiligen Inhaber.
  81.  
  82. -----------------------------------------------------------------------------
  83.  
  84. Was ist QPEG?
  85. ~~~~~~~~~~~~~
  86.  
  87. QPEG (Quick-jPEG, ausgesprochen "Q-Peg" [kju:peg]) ist ein Anzeigeprogramm
  88. (viewer) für JPEG-Bilddateien.  Soweit ich weiß, ist es der schnellste
  89. existierende JPEG-viewer für MS-DOS.
  90.  
  91. JPEG (Joint Photographic Experts Group, ausgesprochen "Jay-Peg") ist ein
  92. Bildformat, das eine verlustbehaftete Kompression verwendet.  JPEG-Bilder
  93. (üblicherweise mit einer "JPG"-Endung) sind sehr klein und bieten eine
  94. bessere Kompression als andere Grafikformate (einschließlich GIF).
  95.  
  96. Das Dekodieren und Anzeigen von JPEG-Bildern ist ein recht komplizierter
  97. Prozeß, daher benötigt er viel Rechenleistung (und Zeit).  QPEG nutzt
  98. die Vorteile und Möglichkeiten von 80386-Prozessoren, und es verwendet
  99. umfangreiche Tabellen anstelle von Berechnungen.  Nun, ich möchte nicht
  100. in die Details gehen.  Es ist schnell, das ist alles was wichtig ist zu
  101. wissen.
  102.  
  103.  
  104. Eigenschaften
  105. ~~~~~~~~~~~~~
  106.  
  107.  - Es ist schnell (habe ich das schon erwähnt?).
  108.  - Kann eine "Vorschau" (preview) eines Bildes zeigen, was sogar noch
  109.    schneller ist.  Hervorragend geeignet, um schnell durch große Mengen
  110.    von Bildern zu blättern; und sehr nützlich, wenn man nach einem
  111.    bestimmten Bild sucht.
  112.  - Arbeitet sogar mit einer Standard-VGA-Karte zusammen (320x200x16,
  113.    640x480x16, 320x200x256).
  114.  - Unterstützt viele SuperVGA-Karten, sowie pratische alle Karten, die
  115.    VESA-kompatibel sind (oder VESA-kompatibel gemacht werden können).
  116.  - Durch seine offene Architektur kann QPEG problemlos um weitere
  117.    Grafiktreiber erweitert werden, ohne daß QPEG geändert werden muß.
  118.  - Verwendet Truecolor (16 Mill. Farben), Hicolor (32000 Farben),
  119.    256 Farben (entweder als Graustufen-Darstellung oder als geditherte
  120.    Farben) und 16 Farben (geditherte Graustufen-Darstellung).
  121.  - Man kann das Bild rollen, wenn es größer ist als die Bildschirmauflösung
  122.    (benötigt XMS- und/oder EMS-Speicher).
  123.  - Man kann die Auflösung interaktiv ändern, ohne daß das Bild neu geladen
  124.    bzw. dekodiert werden muß (dies ist beschränkt auf die gleiche Farbzahl,
  125.    z.B. kann man nicht von Hicolor auf Truecolor umschalten, ohne daß das
  126.    Bild erneut geladen werden muß).
  127.  - Unterstützt auch GIF-Bilder (interlaced und nicht interlaced).
  128.  
  129.  
  130. Systemvoraussetzungen
  131. ~~~~~~~~~~~~~~~~~~~~~
  132.  
  133.  - 80386 oder besserer Prozessor (33 MHz mindestens empfohlen)
  134.  - VGA-Grafikkarte (SuperVGA empfohlen, QPEG läuft allerdings auch auf
  135.    jeder Standard-VGA-Karte).
  136.  - XMS- und/oder EMS-Speicher (abhängig von der Bildgröße), allerdings
  137.    läuft QPEG auch ohne XMS/EMS, aber dann kann man größere Bilder nicht
  138.    rollen.
  139.  - MS-DOS 5.0
  140.  
  141.  
  142. Wie man QPEG benutzt
  143. ~~~~~~~~~~~~~~~~~~~~
  144.  
  145. Als erstes muß QPEG für Deine Video-Hardware konfiguriert werden.
  146. Bitte lies die Datei INSTALL.DOK für weitere Informationen darüber.
  147.  
  148. Dann einfach 'QPEG' zum Starten eingeben.  Es gibt einige Kommandozeilen-
  149. parameter ('QPEG /?' listet sie auf), aber sie werden normalerweise nicht
  150. benötigt.
  151.  
  152. Die grafische Benutzeroberfläche von QPEG ist ziemlich intuitiv, daher
  153. erübrigt sich eine ausführliche Beschreibung.  Im oberen Bildschirmbereich
  154. befindet sich eine Liste aller Tastenfunktionen, die bei der Verzeichnis-
  155. anzeige zur Verfügung stehen.  Mit der Taste '?' kann man sich eine Liste
  156. aller Tastenfunktionen anzeigen lassen, die während der Anzeige eines
  157. Bildes zur Verfügung stehen.
  158. QPEG kann jederzeit mit der Tastenkombination Alt-X verlassen werden.
  159.  
  160. QPEG kann auch Bilder von der Kommandozeile aus anzeigen (ohne die
  161. Benutzeroberfläche); dazu einfach 'QPEG' gefolgt von einem oder mehreren
  162. Dateinamen und/oder Verzeichnisnamen eingeben.  Jokerzeichen ('*' und '?')
  163. sind auch erlaubt.
  164.  
  165.  
  166. Einschränkungen und Fehler
  167. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  168.  
  169. Die grundlegenden JPEG-Dekodierungsroutinen von QPEG sind auf maximale
  170. Geschwindigkeit ausgelegt, es ist keine Zeit für Fehlerprüfungen, daher
  171. kann QPEG möglicherweise "abstürzen", wenn es versucht, eine defekte
  172. JPEG-Datei zu dekodieren.  Um das zu vermeiden, kann man die defekte Datei
  173. mit einem anderen JPEG-Dekoder (z.B. DJPEG von Ton Lane / IJG) dekodieren
  174. (in eine Targa-Datei, nicht (!!!) GIF) und wieder komprimieren.  Die
  175. resultierende JPEG-Datei sollte von QPEG ohne Probleme dekodiert werden
  176. können.
  177.  
  178. QPEG kann nicht alle Arten von JPEG-Bildern verarbeiten.  Um genau zu sein,
  179. es kann nur Dateien dekodieren, die dem sogenannten JFIF-Standard
  180. entsprechen.  Siehe 'Technische Informationen' weiter unten für weitere
  181. Einzelheiten.
  182.  
  183. Die maximale Bildbreite ist 4000 Pixel.  Bilder, die breiter sind, werden
  184. von QPEG nicht angezeigt.  Die Bildhöhe ist nicht begrenzt, aber falls sie
  185. zu groß ist, kann es passieren, daß das Bild nicht mehr ganz in den Speicher
  186. (XMS/EMS) paßt, und man kann den unteren Teil nicht sehen, wenn man das Bild
  187. nach unten rollt.  Falls dies passiert, kann man versuchen, einen Videomodus
  188. mit weniger Farben zu verwenden, weil er auch weniger Speicher braucht.
  189. Oder man kann mehr Speicher kaufen :-)
  190.  
  191.  
  192. Wie man die neueste Version von QPEG bekommt
  193. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  194.  
  195. Diese Version ist höchstwahrscheinlich nicht die letzte.
  196. Es gibt verschiedene Möglichkeiten, eine neuere Version von QPEG zu bekommen:
  197.  
  198.  - Man kann sie kostenlos über das Internet bekommen.  Das ist natürlich
  199.    nur möglich, wenn man Zugang zum Internet hat (z.B. über das Rechenzentrum
  200.    einer Universität oder einer großen Firma).  Man kann die aktuellste
  201.    Version von QPEG finden auf dem FTP-Server 'ftp.tu-clausthal.de'
  202.    (139.174.2.10) im Verzeichnis /pub/msdos/graphics.
  203.    Es gibt auch einen Email-Server unter dem Namen
  204.    'mail-server@rz.tu-clausthal.de'.
  205.  
  206.  - Man kann die neueste Version bekommen, indem man sich registrieren läßt.
  207.    Siehe REGISTER.FRM für weitere Einzelheiten.  Die Registrierung ist für
  208.    alle zukünftigen Versionen gültig.
  209.  
  210.  - Wenn man schon ein registrierter Benutzer ist, kann man die neueste
  211.    Version kostenlos als Electronic Mail (Email) bekommen.  Falls das
  212.    nicht möglich ist, kann man sie auch per Post auf einer Diskette
  213.    bekommen, dies allerdings nur gegen einen Unkostenbeitrag von 10 DM
  214.    (oder 10 $US).  Aber bevor Du mir Geld schickst, vergewissere Dich,
  215.    daß es tatsächlich eine neuere Version gibt, ansonsten könntest Du
  216.    eine Version bekommen, die Du sowieso schon hast.
  217.    Meine Email- und Post-Adresse befindet sich am Beginn dieser
  218.    Dokumentation.  Man erfährt sie auch durch Eingabe von 'QPEG /?'.
  219.  
  220.  
  221. Zukünftige Erweiterungen
  222. ~~~~~~~~~~~~~~~~~~~~~~~~
  223.  
  224. Wie bereits erwähnt, ist dies wahrscheinlich nicht die letzte Version von
  225. QPEG.  Die folgenden Erweiterungen sind für zukünftige Versionen geplant:
  226.  - Unterstützung weiterer Bildformate, etwa Targa, PCX, BMP.
  227.  - Mausunterstützung
  228.  - Auswählen von mehrerer Dateien, um sie hintereinander anzuzeigen.
  229.  - Diaschau-Option (slideshow)
  230.  - Verkleinern von großen Bildern.
  231.  - Automatische Auswahl des passenden Videomodus.
  232.  - Unterstützung weiterer SuperVGA-Karten.  Falls Du einen funktionierenden
  233.    Treiber geschrieben hast, der QPEG noch fehlt, sende ihn bitte an mich,
  234.    damit andere Benutzer davon profitieren können.
  235.  - Weitere Erweiterungen.  Falls Du irgendwelche Ideen, Wünsche, Kommentare
  236.    usw. hast, bitte laß es mich wissen.
  237.  
  238.  
  239. Technische Informationen
  240. ~~~~~~~~~~~~~~~~~~~~~~~~
  241.  
  242. QPEG kann Graustufen-Bilder dekodieren, die eine einzelne h1v1-Komponente
  243. enthalten, sowie Echtfarbbilder, die drei Interleaved-Komponenten enthalten
  244. mit Yh2v2, Yh2v1 oder Yh1v1 für die Y-Komponente und Ch1v1 für die
  245. Cb/Cr-Komponenten.  Damit sind praktische alle JFIF-Dateien abgedeckt.
  246.  
  247. QPEG kann Dateien mit Restart-Markern verarbeiten, verwendet diese allerdings
  248. nicht zur Feherkorrektur.  QPEG ist auch in der Lage, JPEG-Dateien
  249. anzuzeigen, die mit dem 'Adobe Photoshop' (zumindest Version 2.5) erstellt
  250. wurden.
  251.  
  252. Die grundlegenden JPEG-Dokodierungsroutinen sind in reiner 386-Assembler-
  253. sprache geschrieben, alles übrige mit Borland Pascal 7.0.  Ich benutze
  254. keinen Protected-Mode, weil das die Dekodierung eher abbremsen würde anstatt
  255. sie zu beschleunigen.  Ich habe die JPEG-Routinen in eine einzelne, einfach
  256. zu verwendende Pascal-Unit gelinkt, die auch innerhalb anderer Programme
  257. verwendet werden kann.  Falls Du die Unit erwerben möchtest, drucke bitte
  258. die Datei JPEGUNIT.PAS aus und sende das ausgefüllte Formular mit geeigneter
  259. Bezahlung an mich.
  260.  
  261. Die JPEG-Unit stellt Prozeduren zur Verfügung, mit der man eine JPEG-Datei
  262. öffnen und schließen kann, sowie den Dateikopf (mit allen enthaltenen
  263. Informationen, etwa Bildgröße, Grau/Farbe usw.) und das Bild (Zeile für
  264. Zeile) lesen.  Sie beinhaltet Routinen, die den Bildinhalt als 24-Bit
  265. Truecolor (RGB oder BGR) ausgeben, als 15-Bit Hicolor, 256 Farben gedithert,
  266. als 256 Graustufen, 16 Graustufen (gedithert), sowie als 16 Graustufen mit
  267. Verkleinerung auf ein Achtel oder ein Viertel.
  268.  
  269. -----------------------------------------------------------------------------
  270.